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Section 1 — Introduction 

Welcome to the Boston Community Information System ■— the Boston CommlnS! We are pleased to 
welcome you as a paiticipant. I his experiment is a test of a new way ot distributing world news and 
features from the Now York limes (NY I) and the Associated Press (AP) wire service directly to 
people's personal computers via radio waves. With our software and a special radio receiver 
connected to your IBM (or compatible) personal computer, you can receive up -to the -minute 
information on the myriad topics carried by the New York Times and AP wire services, including world 
news, local events, financial reports (and some closing stock prices), business news, editorials, 
commentaries, features on the arts, and weather forecasts. With the Boston CommlnS, you may even 
receive information on these topics before its announcement on the radio cr its publication in a 
newspaper! 

The Boston CommlnS turns your computer into a personal information assistant that monitors the 
news as it happens. Acting on your instructions, your computer will "filter" this flow of information, 
saving the stories that match your list of interests. Thus, you can waik up to the system at any time, 
Line! browse through the stories that the system has saved for you. Because your personal computer 
can receive and filter much mote information than you could read yourself, it can help you focus and 
enlarge your awareness of the world. You will probably find that the system consistently finds more 
a; tides of interest on certain subjects than you do. 

Additionally, users with a modem may access a full database of New York Times articles that is stored 
on several database servers at MIT. The commands used to access this database are exactly the 
i.ame as those which allow you to access the articles saved on your system. 

For best results, we recommend that you leave your personal computer running with the Boston 
CommlnS software running whenever you are not using your personal computer for another task. 
!;ie radio station that carries our transmissions is on the air 20 hours per day. If you leave your 
system running overnight, it will be ready the next day with the latest news. Most news is transmitted 
several times a day, so you can use your personal computer for other tasks without fear that you will 
miss an important article. Additionally, the program can be used in a background mode with 
programs like DesqView (TM) and Double- Dos (TM) with only 256K devoted to the software. 

This User's Manual is designed to tell you everything you need to know to set up and operate the 
equipment and software loaned to you. We have prepared this manual for new and experienced PC 
users alike. We hope the manual will answer all your questions about connecting our special digital 
receiver to your PC, about using the software for the first time, and about customizing the software for 
your personal use. If you have difficulties, try re-reading this manual, especially the appendix on 
trouble-shooting, but if the difficulties persist, do call us for assistance at the Boston CommlnS 
'HOTLINE', (61 7)-253-0007. 

Because this is an experiment, we are very much interested In your thoughtful evaluation of the 
Boston CommlnS. Not only do we want your first impressions of the system, i.e. your ideas en making 
the system easier to use during the first few hours, but we also want your later impressions, i.e. your 
suggestions and advice (on all aspects of the system) from the perspective of an experienced user. 
To this end, we will send you a Questionnaire each month, which you should return to us promptly. In 
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truth, we hope that you will send us additional information as the spirit moves you; we want to know 
your full thoughts on the system, not just your responses to the monthly questionnaire. In a sense, 
the monthly questionnaires represent a minimum of feedback and evaluation from you; please do 
send more if you wish. 

As a participant in this experiment, you have signed an agreement concerning your responsibilities. 
Note that you must abide by this agreement, in spirit and in letter, or you will be asked to return all 
loaned equipment and software to us immediately. 

We welcome you to this experiment to test the Boston CommlnS, and we are looking forward to 
working with you in the coming months. 




Professor David K. Gifford 
Massachusetts Institute of Technology 
Cambridge, Massachusetts 
September, 1986 
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Organization of this Manual 

This introduction is followed by throe more sections, which describe, in turn: 

• the capabilities of the CommlnS software, and how to use it; 

• the information services provided by the Boston Commlns; and 

• how to put together your own personalized 'news filter'. 

There are seven appendices. Appendix 1 is the most important one for new users: it describes how to 
connect the receiver to your PC, and how to install and run the software. Appendix II is a guide to 
help users set up their modem for use with the remote system. 

Appendix III is a trouble-shooting guide, and contains descriptions of common problems and their 
solutions. 

Appendix IV is designed for users experienced with previous versions of our software. It describes 
the basic changes in the current program. 

Appendix V is the reference section: all the commands are listed here. Appendix VI describes the files 
used by the system, and finally, Appendix VII contains a few words about the responsibilities of 
participants in the Boston CommlnS experiment. 

How to Use this Manual 

First-time users should proceed in the following order: 

• First, you should read Appendix I — Getting Started and follow the instructions for unpacking 
the equipment, installing it, and installing the software. 

e After you install the hardware and software, you should read Section 2. It includes instructions 
for first-time users that you should follow. These instructions guide you through the section 
quickly and superficially, to give you a general idea of how to use the Ccmmlns software. 

o Next, you should skim Sections 3 and 4, to learn about the information services that are 
available, and to learn how to put together your own news filter. 

• Finally, you should turn back to Section 2, read the parts that you were asked to skip on first 
reading, and try out all the different commands. 

Start with "Appendix I — Getting Started". Good luck! 
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Section 2 — Using the CommlnS Software 
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Figu re 2- 1 : The Screen Layout and the Window Selection Menu 

As shown in Figure 2-1 , the CommlnS software divides the screen of your PC into four separate areas: 

• The status line is the highlighted line at the top cf the screen, in addit ; on to the date and time, 
the status line indicates which window is displayed below, which line or summary in the window 
is selected (if any), which lines or summaries are shown, and how many lines or summaries the 
window contains. 

• The query line , also highlighted, is the third line from the bottom. The purpose of the query line 
is described in Section 2.1 . 

• The message area occupies the bottom two lines of the screen. Messages from the system 
(such as acknowledgments and error messages) are displayed here. 

• The window display occupies the remainder of the screen. It is used to display the following 
five windows: 

o the filter window , which contains your news filter, 
o the summary window , which contains article summaries, 
o the article window , which contains articles, 

° the d iagnostic window , which contains details about the system's operation, and 
o the options window , which contains the setting of various controls that you can change. 
When the system starts up, it displays the filter window. To find out how to ask the system to display 
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the other windows, press F3 1 : this instructs the system to show the window selection menu (see 
Figure 2-1).' A njdULL is a highlighted box containing a list of commands , one of which (the se[nctod_ 
command) appears on a contrasting background. You can use the j and ] keys to select any 
command in a menu; when you press <Enter>, the selected command is executed . If you do not want 
to execute a command, you can select no nothing, or you can press the shorthand key <Esc>. If you 
press a key other than .j , t or <F.nter>, the system will remove the menu and then act upon the key you 
piessed.' 

You can use the window selection menu (see Figure 2-1) to instruct the system to display any of the 
live windows. As an alternative, you can simply press the corresponding shorthand key shown in the 
menu (F2 for the filter window, F4 for the summary window, and so forth). The status line (at the top 
of the screen) always indicates which window is being shown. The shorthand keys work whether or 
not there is a menu on the screen; thus, you can always ask the system to display any of the five 
windows by pressing F2, F4, FS, F8 or F10. If this is your first time using the system, you should take a 
look at the other windows before you read on. 

If a window contains more than one screenful of text, this is indicated in the status line. To see whole 
text of the window, use the sc roll keys : 

<PgDn> Show the next page. 

<PgUp> Show the previous page. 

<Home> Show the first page of the window. 

<End> Show the last page of the window. 

In the filter window and the summary window, you can also use the the following keys: 
Shift- 1 Move forward one line (or summary) 

Shift-j Move back one line (or summary) 

| Select the next line (or summary) 

| Select the previous line (or summary) 

The shift key used in conjunction with j and | has the same effect as using the numeric lock key. 
That is, use of this feature causes the screen to shift as opposed to only cursor movement. 

Each of the five windows has its own set of commands: for example, the filter window has a command 
for adding now filter lines, the article window has a command for going to the next article, and so on. 
The commands for each window are noted in the c ommand menu for that window. When you are 
looking at a window, press / to see the corresponding command menu. You can display all five 
command menus in turn by pressing F' :> /, F4 /, F6 /. and so forth. Note that every command has a 
shorthand key, which is listed to the right cf the command in the menu. 

For your protection, some commands (such as delete all matching articles) ask for confirmation 



"F3" refers to the gray function key on the left side (or top for some compatibles) of the keyboard labeled F3. Similarly, F1, 
F2, etc. refer to She other function keys. 

2 

When you pi ess a key, the system usually responds right away. However, when the system is writino a new article on the 

disk, it responds only after the whole article has been written. 
' Thus, you can also remove a menu by pressing the space bar. 
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before they do anything When you execute such a command, a co nfirmation box appears on the 
screen. A confirmation box is a tiny menu with only two options: do nothing and execute. Select 
exfcuie and press <f;iitor> if you wish to go ahead, or use the shorthand A E.' 1 If you wish to cancel 
the command, execute the do nothing command or use the shorthand <Esc>. 

A help file is provided with the system which contains an overview of some basin commands. If this is 
your first time using the system, you should press Fl and look through this help file. It also contains 
some information not yet covered. You can view this file any time by pressing F1 . 



The prefix "A-" refers to the <Alt> key: for example, A-E means "hold down the <Alt> key and press e". Similarly, the prefix 
'C-" refers to the <Ctrl> key: for example, C-D means "hold down the <Ctrl> key and press d". 
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2.1 — The Filter Window 
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Figure 2-2: The Filter Window and its Command Menu 

The CommlnS software monitors the information that comes in via the receiver, and "filters in" the 
articles that match your interests, based on the filter . Thus, the filter serves as your personal "interest 
profile". The filter on the distribution disk serves only as an example to get you started — you will 
soon learn how to customize the filter for your personal use. 

Press F2 to see the filter window (see Figure 2-2). Each line in the filter corresponds to a specific 
topic. Each filter line is preceded by a number in parentheses, which indicates how many articles 
matching that line are on the disk. 5 

One of the filter lines is highlighted: it is called the selected line . 6 You can select any line in the filter 
by means of the scroll keys, i.e. f, I, <PgDn>, etc. When you select a particular line, the contents of 
that line appears on the query line so that you can use it as a query . If this is your first time using the 
system, select a line for which the number of matching articles is not zero, and press <Enter>. 7 When 
you press <Enter>, the system processes the query on the query line, and displays summaries of the 



If there are two numbers in front of each filter line, as is the case in Figure 2-2, the number before the "/" is the number of 
matching articles. The second number is the budget for that filter line; budgets will be discussed shortly. 

If none of the filter lines appear brighter than the rest, press <Home> and adjust the brightness and contrast controls on 
your PC until the first filter line appears brighter than the rest. 



If none of the filter lines have any matching articles, turn to the Appendix on trouble-shooting. 
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articles that match the query. The summary window is described in the next subsection. If this is your 
first time using the system, turn to the next subsection after you have pressed <f£nter>. 

Because disk space and memory are limited, the system does not save all matching articles 
permanently. When the system runs out of space, it deietes old articles to make room for new ones. 
You can teil the system how many matching articles you would like to keep for each filter line by 
specifying a hudtjei for each line. If iiiis is your first time using the system, press F2 to see the filter 
list; then pi ess AS to display the budgets if they are not visible. For each filter line, the system will try 
to keep at least as many articles as the budget indicates, and perhaps more if there is enough room. 
You can change the budget of any filter line by selecting that filter line, and pressing ">" to increase 
the budget, or "<" to decrease it. 

When the system needs to delete an article to make room for a new one, it will first attempt to delete 
one from a filter line that is "over budget". If several lines are over budget, an article wil! be deleted 
from the last such line in the fliter. If all the filter lines are within their budgets, an article will be 
deleted from the last line in the fiiter that has matching articles. Because the system deletes articles 
from the bottom of the filter first, you should arrange your filter so that the topics that interest you 
most appear near the top. You can rearrange the lines in the filter by pressing A-U (or AN) to move 
the selected line up (or down) in the filter. This is better than deleting the line and re-inserting it 
elsewhere, because when you delete the line, articles that match only that line will be deleted. 

To find out what you can do in the filter window, press F2 (to see the filter window), and press / to see 
the corresponding command menu (ree Figure 2-2). You can execute any command in the menu by 
selecting it (using j and }) and pressing <Enter>, or you can use the shorthand keys. Most of the 
command names are self-explanatory; if this is your first time using the system, please go ahead and 
try out the various commands. The commands are briefly explained below, with more detail about 
several of the commands below. 

■> do nothing (with shorthand <Esc>) — this command removes the menu. 

a show window SELECTION menu (F3) — this command shows the window selection menu; it is 
listed primarily to remind you of the shorthand key, F3. 

• snow summaries (Enter) — this command shows brief summaries of all articles matching the 
current query thai are saved en disk. 

• show remote summaries (ConT ol-Enter) — this command will send the query to our New York 
Times database and show brief summaries of all articles matching the current query that are 
found in the data at MIT. 

o show eirst article (A-R) — this command display the first article on disk that matches the 

current fiiter line. 
« delete all articles in list (A-K) — this command deletes all the articles on the disk that match 

the current filter line. Articles that match more than one line are not removed. This command 

will ask for confirmation first, 
*> print all articles in list (A-A) — this command prints all the articles that match the current 

filter line. 

• change budget of current line (A-B) — this command puts the cursor in the budget field of 
the current fiiter iine and lets you change the budget. This command requires ycu to press 
<Enter> when you have finished entering the budget. 
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• insert A new line (A I) — this command inserts a new filter line, puts the cursor in it, and lets 
you edit the new line. This command requires you to press <Enter> when you have finished 
entering the filter line. 

• rlmovl current LiNE (A-W) this command removes the current line from the filter list and 
deletes all matching articles. 

• move current linf up (A-U) •- ■ this command moves the current filter line up in the filter list. 
See the preceding paragraph about filter line priority. 

e move current line down (AD) — this command moves the current filter line down in the filter 
list. See the preceding paragraph about filter line priority. 

• turn beep-on-arrival on/off (A-1) — this command toggles the feature that rings the bell 
upon arrival of an article matching the current filter line. This feature is described below. 

• turn print-on-arrival on/off (A-2) — this command toggles the feature that prints all articles 
that match the current filter line upon arrival. This feature is described below. 

• exit to DOS (AX) — use this command if you want to turn off the PC or if you want to use the 
PC for something else. This command requires confirmation 

The show summaries command, with shorthand <Enter> 8 , instructs the system to process the query 
on the query line. Usually, the query line contains a copy of the current filter line. However, you can 
submit any query you like by editing the query line before you press <Enter>. The q uery languag e is 
described in Section 4. Note that while any valid query is permitted as a filter line, you can locally 
process only queries that contain only words and phrases that occur in the filter. 

Queries which contain words or phrases which do not already appear in your filter will be 
automatically submitted to the remote database if the program was started with the -d option. If a 
query is not specific enough to process at the remote database, the program will, if possible, a menu 
of terms which may be added to the query in orde. to process the query remotely. You may choose a 
term from the menu, or select do nothing to cancel the query (see Figure 2-5). 

A query which can be answered locally (on your PC) may be submitted to th-c remote database: select 
show summaries from remote system from the menu, or press <C Enter> instead of <Enter>. 

You can customize the filter by adding and removing lines, by re-ordering lines, and by changing their 
budgets (see Section 4 — The Query Language) To add a new line to the filter, select a line at the 
point where you want to insert the new line, and s:lect the insert a new linl command or press (A-l). 
The system will create a new filter line, containing a copy of the query line and place the cursor in it. 
You can use the edit keys to edit the new filter line if you wish. After editing the new filter line, press 
the <Enter> key to install it in the filter. If you change your mind and you decide that you do not want 
to add a line after all, press <Esc>. 

When you delete a filter line, the matching articles are also deleted. 10 For this reason, the remove 
current line (A-W) command requires confirmation. 



Since <Enter> Is also used to initiate processing on menus, it can only be used as shorthand when there is no menu on the 
screen. 

g 

" I he editing keys are described in Appendix V.3 — Editing Keys. 

L Except for articles that match one or more othor lines as v ell. 
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Figu re 2-3: The Filter Window with the Remote Query Routing Menu 

You can 'mark' a filter line so that the system will ring the bell when a matching article arrives. This is 
called "beep-on-arrival", and you can turn it on and off (for the selected filter line) by pressing A-1. 
Filter lines that have "beep-on-arrival" set are identified by a musical note in the margin. You can 
also mark a filter line so that the system will print all articles matching that line as they arrive. This is 
called "print-on-arrival", and you can turn it on and off (for the selected filter line) by pressing A-2. 
Filter lines that have "print-on-arrival" set are identified by the symbol Pt in the margin. If a line has 
both "beep" and "print" set, only the Pt symbol appears. 

The last line of the filter, displayed as an asterisk (*), is not really a filter line; it matches every article 
on the disk, and the number of articles matching it indicates how many articles are on the disk. The 
budget of this line is called the system budget, and it indicates the maximum number of articles that 
the system will keep. You can change the system budget just as you change the budget of a filter line, 
by pressing '>' or '<' or by executing the command change budget of current line. If you have a 
hard disk, you can limit the size of the \news directory by setting the system budget to, say, 100 
articles. The system budget is limited by the amount of free memory: when the system runs out of 
memory, it reduces the system budget accordingly. 
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2.2 — The Summary Window 



Summary Window ili ' Viewing match 1 through 2 e-f 2 
>aug 20, 12:22 C41 lines) Urgent (Financial) 

NEW YORK (AF 1 ) _ The stock market edged upward in an erratic 

session today, faced with new evidence of sluggishness in the 

economy. 

aufl 19, 12«20 (47 lines) Urgent (Financial) 

NEW YORK (AP) _ The stock market moved low ,,.,,, 



aug 20, 12:41 



(not read) 



blue chip stocks sported gains. 



:0» wcrfchvhg.; ;'■ ■': tESE* 

Show current article <A-R) 

Salt**** :CUrf «Rt: : »Tt*C:i:«:: V,' : .iX\. : ';5SteO?:! 
:0»i«fc» ::*l;l-:;«r*±fii;«i.>*nv*:*:Wfc ';$jte4£t; 

Print cwrr«^t: : ^ifcifei#, : : : : ':- : .: iftTP) 
Ey.it t'i> bcs . ;y ;- "■'. «>-x> 



f>sufcjf»eti Nail street)- 

The receiver is running on port 1 

Welcome to the MIT Community Information System 



Type Fl for help 



Figure 2-4: The Summary Window and its Command Menu 

The summary window (see Figure 2-4) contains summaries of the articles that match a particular 
query or filter line. If this is your first time using the system, press F4 to see the summary window. 

Each article summary is preceded by a highlighted line containing: 

• the date (and time) of the article, 

• the number of lines in the article, 

• the priority of the article, and 

• the general subject area of the article. 

If the article has not yet been displayed, the header line also contains the words (not read). The 
header line is followed by a brief "summary" of the article. 11 The summ?;ies are listed in reverse 
chronological order, i.e. the summary of the most recent article is listed first. 

The arrow to the left of the summaries points to the selected summary . You can select any summary 
in the summary window using the scroll keys.™ 



We do not employ someone to read the articles and write summaries. Instead, the system automatically extracts the first 
sentence of each article to display as the summary. In most news articles, the first sentence provides a reasonably good 
summary. Sometimes, as you will discover, it doesn't. And sometimes our automatic procedure for finding the first sentence 
doesn't work. 

12 

When you use the scroll keys, the system will select a different summary if this is necessary to ensure that the arrow 

remains visible on the screen. 
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To learn what you can do in the summary window, press / to see the command menu (see Figure 
2-4). The command menu contains the following commands: 

• do nothing (with shorthand <Fsc>) -- thi:; command removes the menu. 

• snow window slleciion menu (13) — this command shows the window selection menu; it is 
listed primarily to remind you of the shorthand key, F3. 

© snow current article (A-R) — use this command if yen wish to read the article corresponding 
to the selected summary. If this is your first time using the system, you should select this 
command, press <Enter>, and turn to the next subsection. 

• delete current article (AD) -- this command deletes the article corresponding to the 
selected summary. It does not ask for confirmation. 

Note: Articles which have been received from the remote system can not be 
deleted. 

• delete all articles in list (A-K) — this command deletes all the articles whose summaries are 
in the summary window. It wili ask for confirmation first. The number of articles in the summary 
window is listed on the status line. 

« print current article (A-P) — this command prints the article corresponding to the selected 

summary. It works only if your PC is equipped with a printer and the printer is turned on. 
o print all articles in list (A-A) — this command prints yli the articles whose summaries are in 
the summary window. The number of articles in the summary window is listed on the status 
line. 

Note: Remote articles cannot be printed from the summary window. To print a 
remote article, retrieve the article (using the show current article command), 
and print it from the article window (as described in Section 2.3). 
« EXiT to dos (A-X) — use this command if you want to turn off the PC or if you want to use the 
PC for something else. This command requires confirmation. 

liOte: The summary window always contains the summaries from the last query processed. Thus, 
even if you change the query line and press F4 again, the contents of the summary window will remain 
the same. The following two commands, which are listed in Section 2. 1 — The Filter Window, are the 
only ones that create a new list of summaries: 

<» SHOW SUMMARIES 

• SHOW FIRST ARTICLE 

• SHOW REMOTE SUMMARIES 
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2.3 — The Article Window 



aug 20, 12:43 



otitis Window tft«08204w 4323 Wsxiit^ lioe* ls?i o-f. 42 
type: AP Copyright 1986 The Associated Press 
priority: Urgent 
date: OB-20-86 1222EDT 
category: Financial 
subject: F'M Wall Street Noon 
text: 

NEW YORK (AP) _ The stock market ed 
session today, -faced with new evidence of 
economy. 

The Dow Jones average o-f 30 industr 
noontime on Wall Street. 

Gainers outnumbered losers by about 
o-f New York Stock Exchange-listed issues. 

Be-fore the opening, the Commerce De 
housing starts dropped 1.8 percent last mo 
considered an indicator of -future construe^ 
deel i ned. 

The housing starts -figure has now -fallen -for three consecutive 
months, something it had not done since 1981. 

Housing has been one o-f the -few bright spots in the economy this 
y. ea . r - Brokers say that i -f activity in that sector dwindles 
•Jsubiect* iN^li stf-eet* . •• 



:Rd'':Fl<5tb &«£ ' ; .'•:■ 




■':ifeSfeiii': 


:ShO«; «j : n«feW: :««t:6ict i Of5 flWSfcttU 




■ VF5$ :: 


Show next a'r t i ci'e 




"(A-N) 


:St«M* nex*: iirir*asf: «r*S cl»; ; .'■■•; 


:w»ss;*«hz*; 


Bisl e*«* stftian : sttcw? next ; -ar-M tea* *A-B!> '■ 


JDe?:»fcBi:r th»rt: .^aw: '«»«*> ttnreicj :. ;'.' ; : i£t*a*:: 


■fie^e-ie., then shew *ubk»ww1>». <A-W.> : 
Ptiitf.- stiffed ir%i<J>.- • iA~pil 



The receiver is running on port 1 

Welcome to the MIT Community Information System 



Type Fl -for help 



Figure 2-5: The Article Window and its Command Menu 

The article window (see Figure 2-5) is used to display articles. You can move up and down through 
the article using the scroll Aeys. 13 If this is your first time using the system, press F6 to see the article 
window. 

Most articles contain several words that matched your filter. The first occurrence of each such word 
is highlighted, so you can scan an article quickly and determine why it matched the filter. 14 This is 
useful because filter lines sometimes match out of context, filtering in articles that do not interest you 
at all. If a particular filter line matches a lot of articles that do not interest you, you may wish to make 
that filter line more 'specific' — this is explained in Section 4. 

To find out what you can do in the article window, press F6 (to see the article window), and press / to 
see the corresponding command menu (see Figure 2-5). 

show next article is probably the most useful command. It instructs the system to display the article 
corresponding to the next summary in the summary window. If there are no more articles, the system 
puts a message in the message area, and displays the filter window. 

The CommlnS software remembers which articles it has displayed. If you don't want to see the same 
article twice, you can use the command show next unread article instead of show next article. 
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<PgDn>, <PgUp>, (Home), <End>, etc. 

There is no highlighting in articles received from the remote database. 
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When you have read an article, you can delete it (to make room for new articles). Depending on what 
you want to do next, you can use the command delete, then show next article, the command 

DELETE, THEN SHOW NEXT UNIIEA1) (AliilCI I ), Ol' tllO Command DELETE, THEN SHOW SUMMARIES. 

Note: Hemole ai tides cannot be deleted. 

If your PC is equipped with a printer, you can /;///)/ the article using the command print current 
article. If only a portion of a remote article has been received when a print command is issued, only 
that portion will be printed; in order to ensure that the complete article has been received before 
printing, wait for the * * End of Article * * line to appear at the end of the article. 

As always, ycu can use the command exit to dos if you want to turn off the PC or if you want to use 
the PC for something else. 



Note for first-time users: 

If this is your first time using the system, we recommend that you: 
e turn to Section 3 — Databases and Services, and skim it to learn about the information 

services that are available through the Boston ConimlnS; 
* skim Section 4 — The Query Language, to find out how to put together a news filter 

that filters in the information you are interested in; 
» after that, turn back to the beginning of this section (Section 2), read the parts that you 

were asked to skip on first reading, and try out all the different commands. 
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2.4 — The Diagnostic Window 



:34 



aug 20, 12 



The system has been running since 
An article was last received at 
An article was last accepted at 

Articles broadcast since system startup: 

Articles received: 

Articles with unknown keys: 

Articles matching the -filter: 

Articles accepted: 

Articles presently on the disk: 

Articles currently in print queue: 



Un framed packets: 

Framed packets: 

Checksum errors: 

Intact packets: 

Dupl i cati ons: 

Accepted: 

Mem: 323608, R-frk 



aug 2U, 
aug 20, 
aug 20, 

27 
27 



i: 

12:49 
12:49 



90 




1 

1009 



1009 

487 



904, Kfrk: 210, Rrcv-frk: 946, Rmt-frk: 608, C-frk 



194 



2:49^ 



t>» nothing (£SS* 

Show window selection menu (F3) 

iCKitt:/ *W :' ©BS ■'■■ <■'■■ .7: /! :;;,■,,: rf^**- 



i sublet: t «iAi 1 «st<-^et J 

Article matched: (category: news) (priority: urgent I bulletin V -flash) 

Article matched: wang or "data general" or "digital equipment" or "analog device 



Figure 2-6: The Diagnostic Window and its Command Menu 

The diagnostic window contains information about the operation of the Boston Commlns software. 
This information is updated continually. If your system is working correctly, you should have no need 
for this window at all. If this is your first time using the system, press F8 to see the diagnostic window. 

In the Boston CommlnS radio transmissions, each article is divided into "packets" that are 
transmitted separately. Each packet is 'checksummed' to permit error detection, and broadcast twice 
to permit error recovery. The CommlnS software receives packets, verifies the checksum, and 
discards duplicate packets. The most important indicator of system performance is the number of 
'intact packets" received. During normal operation, the number of "intact packets" received should 
be increasing steadily, at a rate of about three per second, occasionally interrupted by brief pauses 
that are followed by rapid catching up. If the number of "intact packets" is not increasing, turn to the 
trouble-shooting guide in Appendix III. 

All "intact packets" are "accepted", unless they are "duplications" of packets received earlier. Since 
every packet is transmitted twice, the number of "duplications" should be approximately equal to the 
number of "accepted" packets. 

If a packet is "unframed", or contains a "checksum error", it is not received "intact". These numbers 
are an indication of reception quality. If your receiver is functioning well, the number of "unframed" 
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packets and 'checksum errors' should be very small, probably less than ten per day. 15 When the 
radio station is off the air (usually from 2 am to 6 am) the number of bad packets will increase. 

You can yet a sense of the percentage of articles that actually match your filter by comparing the 
number of "articles matching the filter" with the number of "articles broadcast since system startup". 
The number of matching articles that are actually written to the disk is listed as "Articles accepted". 
The number of "Articles presently on disk" is the number of articles on the disk. 

You may reset all of the statistics counters by selecting the reset counters to zero (A-0) command. 
Fur legal and policy reasons, all our information broadcasts are digitally encrypted. Different kinds of 
information are encrypted using different keys. The software distributed for this experiment contains 
keys for the New York Times and AP articles, as well as for system announcements. Articles that are 
intended for a limited audience (for example, personal mail) are encrypted using keys that are not 
distributed to the general public; when such articles are received, they are counted as "articles with 
unknown keys". 

If you instruct the system to print one or more articles, in the background, the number of "Articles 
currently in print queue" indicates how many articles remain to be printed. You can stop printing and 
clear the print queue at any time using the shorthand key A-Q. 

The bottom line in trie Diagnostic window indicates the amount of free memory, and the amount of 

unused stack space in each of the 'forks' (internal processes) of the program. 16 Mem is the total 

amount of memory that is not allocated. Memory is allocated for each filter line, and for each article 

en the disk. 

Rfrk is the amount of unused stack sp&ce in the receiver fork. The receiver fork receives data, checks 

packets, assembles them into articles, decrypts the articles, matches them against the filter, and 

writes new information to disk. 

Kirk is the amount of unused stack space in the keyboard fork. The keyboard fork processes all 

keystrokes and commands. 

Cfrk is the amount of unueed space in the clock fork. The clock fork is responsible for periodic 

processing, such as updating the clock in the upper right corner of the screen. 

Rmtfrk is the amount of unused space in the remote processing fork. The remote fork manages 
communications with the remote database server. This will only appear if the duplex system is 
selected when the CIS program is started. 

Ftncvfrk is the amount of unused space in the remote receiver fork. This fork receives and processes 
Information from the remote database server. This will only appear if the duplex system is selected 
when the CIS program is started. 



"There will usually be at least one "untrained" packet, because when you s'.art up the Boston CommlnS program, odds are 
that it wiil receive ihe end of a packet before it begins to receive whole packets. 

This information is provided primarily tor the system implementors; there are no "user-serviceable parts" within the 
Boston CommlnS software. However, if the amount of free memory gets very small (under 100 for the forks, under 1000 for the 
free memory) you may encounter unexpected problems. This should not happen during normal operation cf the system. 
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2.5 — The Options Window 




The receiver 1 s on 

Budgets are o-f-f 

Receiver is on port 1, modem on port > 

Print queue length: articles 

Frinting on IBM printer in background 



aug 20, 12 



The receiver is running on port 1 

Welcome to the MIT Community Information System 



J x 42^ 



me**. ' : ■&*&## ;^j ettft^s** m&m. -■ •: : ^? / : 

turn receiver ori/off ^!T.9.'.. 

Turin bMsf^Rt <*£spiay oo/o+4 '■• *A-S> 

Stopi '•:gjr*«itii^:--flif!*:-«^t:*vi^a® " :": ^S* 

Set printer tfitt Graph tea/Other <A-Ci 
161& the screen . ;. <A-£.) 

W^WP *&*$*& ; e>^es$S<»ii : : , '■ : \MHiii 

fait fco 90S ' • <A-KJ 



Type Fl for help 



Figure 2-7: The Options Window and its Command Menu 

The options window shows the setting of various controls that you can change. If this is your first 
time using the system, press F10 to see the options window. 

• The first line in the options window indicates whether the receiver is on or off. You can turn the 
receiver on or off with the command turn receiver on/off, or with the shorthand A-O. When 
you shut the receiver off, the system will respond to your commands more promptly, because it 
won't be writing articles to the disk. On the other hand, you won't receive any new articles. If 
you decide to turn the receiver off so you can read articles without being interrupted, don't 
forget to turn the receiver back on when you're done. 

• Line two of the options window indicates whether or not the budgets are being displayed in the 
filter window. You can turn the budget display on or off with the command turn budget 
display on/off, or with the shorthand A-S. 

• Line three indicates whether the program is listening for articles on port 1 or on port 2. The 
modem which allows communication with a remote database server is assumed to be on the 
other port. If you have two serial ports, you can switch the program io the other port with the 
command swap modem/receiver ports (or with the shorthand A-V). 1 ' 

• Line four indicates how many articles are waiting to be printed. To stop printing and empty the 
print queue, use the command stop printing and empty queue or press A-Q. 
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You can also select a port when you start up the program: see Appendix 1.5. 1 — Starting the Commlns Program. 
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• Line five indicates whether the program is expecting to print articles in the foreground or 
background. Background printing is more convenient because it allows other commands to be 
processed concurrently. I lowever, the CIS program is designed to print in background on IBM 
Graphics printers only. In order to use o.her printers, select the phint foreground command 
from the menu. 

Note that even though this command menu is only available in the options window, the shorthand 
keys described here may be pressed at any time. 

There are several additional commands available in the menu. 

• blank the SCREEN (A-Y) Causes the screen to become completely blank until any key is 
pressed. This may be particularly useful in conjunction with multi-processing systems such as 
DesqView (TM) or Double-Dos (TM) which allow the CIS program tc operate in the background 
while other programs are running on the computer. 

• idle the screen (AC) Similar to blank the screen, this command causes a message to be 
displayed on the screen. The message is displayed in different places on the screen every few 
seconds, so as not to permanently burn the phosphors in the display. 

© hangup connection (A-H) Terminates any connection to a remote database. This frees the 
database server for other users, and hangs up the telephone connection. 
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Section 3 — Databases and Services 

The Boston CommInS provides you with access to two major databases: 

• the text of the New York I mies, and 

• the Associated Press (AP) new:.; wire. 

The Now York Times service includes the complete text of the articles that appear in that newspaper. 
The AP soi vice provides articles on a wide variety of topics. Because the New York limes is a New 
York paper, it does not carry local news for the Boston area. However, the AP service provides 
extensive Boston and New England coverage. 

The New York Times and AP databases are founded on different philosophies. The New York Times 
provides highly polished and readable news stories, corresponding to the printed version of the New 
York Times. Developing news stories are usually updated once a day by their editors. The AP 
service, on the other hand, provides up to the minute reports on breaking news stories, as well as 
corrections, updates, and occasional retractions of previous stories. Thus, you can expect to get 
different kinds of information from these different sources. 

3.1 — Fields 

All news articles follow the same standard format: an article consists of several fields , including the 
text field. Section 4 describes how to take advantage of the information in the various fields when 
you put together your personal news /ilter. 

The set of fields is fixed; the use of the various fields is described below. For an example of how the 
fields are used, just look at any article. 

type The type fieid of an article identifies the source of the article. There are three types of 

articles: "nyt" (Mew York Times), "ap" (Associated Press), and "cis" (announcements 
from the Boston Community Information System). As we expand our information 
services, new article types may appear. 

date The date field indicates the date and time at which article was written. 

category The categcry field identifies the general subject area of an article. The categories used 
by the New York Times and AP editors are described in the next subsection. 

author The author field identifies the author of an article. This field is sometimes left blank by 
the originating information source. Occasionally, the author of an article is identified by a 
by-line in the text fieid of the article. 

priority The priority field indicates the priority of the article, as classified by the originating 
information source. The priority field of an article contains one the following words or 
phrases: 

f 1 ash the highest priority; it is seldom used 

bulletin the priority level of prime news; it is also used for corrections, 

updates, and occasional retractions of previous stories 
urgent the priority level of important news 

regul ar the priority level of routine news 
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Weekday advance 
Sunday advance 
reruns 



deferred the lowest priority level; used for delayed sending of a completed 

story 

material for a future weekday 

material for a future Sunday 

reruns 

subject The sufsject field contains a subject identifier that is assigned by the originating 
information source. Certain subject identifiers are used consistently; some of these are 
listed in Section 3.3. Some articles are actually listings of upcoming articles, and they 
give the subject identifier for each upcoming article (for example, "REAGAN SPEECH"). 
If you are interested in such an article, add a filter iine of the form ( subject: "reagan 
speech" ) to your filter and your system will catch the article. 

title The title field contains the title of the article, if any. Most articles do not have titles. 

text The text field contains the text of the article itself. 



3.2 — Categories 

As will be explained in Section 4 — The Query Language, a filter line or query of the form 
(category: <something>) matches articles whose category field contains <something>. The 
category field is very useful, because the New York Times and AP editors put every article in an 
appropriate category. The following is a list of the categories used. Unfortunately, the categories do 
tend to change with time, so this list is not complete. 



Advi sor ies 
Domestic 
Washington News 



International News 

State and Regional News 
Financial 

Features 

Lifestyle 

Entertainment and Culture 

Racing Results and Entries 

Sports 

Individual Sports Scores 

Commentary 

Travel 

Multiple Categories 



Listing of the subject lines of stories on the news wire 

Domestic news, except for news from Washington D.C. 

News concerning national politics, the United States 

government, actions of tfie President, and congressional 

decisions 

News about foreign events, including articles originating at the 

United Nations headquarters 

News concerning the local Massachusetts area 

Business news, financial indicators, and some stock market 

information 

Feature stories 

Social news 

Articles on entertainment, culture, and the arts, including reviews 

of movies, plays, books, and television programs 

Upcoming horse races as well as results 

Sports features and scores 

Selected box scores 

Editorials and columns 

Travel information and human interest stories involving travel 

Articles consisting of segments that belong in different 

categories; frequently used for announcements of upcoming 
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articles 
Pres idential Flection Election coverage (when applicable) 

3.3 — Subjects 

Our information sources provide a variety of information, such as news summaries, on a regular basis, 
information of this kind is identified using the subject field; for example, the query (subject: 
newssuiinuary) matches the Now Yoik limes news summary, as well as various kinds of AP news 
summaries. In the descriptions below, (NYT) refers to material from the New York Times, (AP) refers 
to material from the Associated Press. The following subject identifiers are used consistently by our 
information sources, but note that they do change occasionally and new subjects may be added for 
events occurring at a particular time, i.e. elections, sport seasons, etc.: 

anderson column Dave Anderson's column (NYT) 

architecture Articles about architecture (NYT) 

arts News about the arts (AP) 

60 minute gourmet What to do for dinner in one hour (NYT) 

baker column Russell Baker's editorial (NYT) 

oba American League Baseball (AP) 

Dbn National League Baseball (AP) 

bbo Combined League Baseball stories (AP) 

berkow column Sports commentary (NYT) 

bestsellers Hardcover bestseller list (NYT) 

biztalk Business news summaries (NYT) 

b i zweek Weekly business story (NYT) 

bkc College Basketball (AP) 

bonds Bond prices (AP) 

uock review Reviews of new books (NYT) 

'ooktal k Column about books (NYT) 

box* Box scores of baseball games (AP) 

briefing Briefing on Washington news and political events (NYT) 

broadway Stories about Broadway openings/closings/reviews (NYT) 

business digest Business news digest (AP) 

ousiness highlights Business news highlights (AP) 

business mirror Column on business (AP) 

calendar Calendar of political events or of crafts, performing arts, and openings in 

the New England area (AP) 

candidates Close-up on political candidates (when applicable) (NYT) 

capitol ideas Column from Washington (AP) 

careers Features on interesting careers (NYT) 

cheese eggs Cheese and egg prices (AP) 

chess Articles on chess (NYT) 

cl a i borne Cooking with Craig Claiborne (NYT) 
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col 1 eges Stories on college sports (NYT) 

column Columns from the Now York rimes 

coiiipuL* Various columns about computers, computing etc. (NYT) 

congress Stories on Congress' actions (NYT) 

consumer column Consumer advocacy column (NYT) 

consumer ra tes Consumer credit rates (NYT) 

win' t Important court rulings (NYT) 

credit Reports on commercial credit markets (NYT) 

credit rates Present commercial credit rates (NY T) 

databank National economic indicators (NYT) 

deaths Obituaries (AP) 

digest briefs Weil-edited news summaries (AP) 

dollar Information on the exchange rates (AP) 

economy Information and articles about the US economy (AP) 

eco Various economic stories (NYT) 

edit* Editorials from the New York Times 

editorial rndp Editorials from New England papers (AP) 

education Stories on education (NYT) 

p1 ections Various election results (when applicable) (AP) 

ex tendeds Three-day extended weather forecasts (AP) 

fashion* Articles about fashion (NYT) 

fhc College football (AP) 

fbn Professional football (National league) (AP) 

f bo Combined ieague football stories (AP) 

f inbrief s Collections of short news items about business and finance (NYT) 

f indigest A daily digest of top financial nev/s from the New York Times. This digest 

is identical io the business digest on the front page of the New York Times 

business section, 

f ol l owups Follow up on the news (NYT) 

food fitness Nutrition articles (NYT) 

football q a Football question column (NYT) 

forecasts Forecasts for around the country (AP) 

foreign affairs Foreign affairs column (NYT) 

foreign briefs Foreign news briefs (NYT) 

foreign exchange Foreign exchange rates (AP) 

frontpage A daily description of the layout of the front page of the New York Times 

global temps Temperatures around ilia world (AP) 

gov finances Figures on Government spending and debt (AP) 

hkn National Hockey (AP) 

hko American League Hockey (AP) 

home video Recent home videotape releases (NYT) 

indexes New York and American Stock Exchange indexes (AP) 

industry news Business news briefs (AP) 
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in terv i ew Various interviews (AP) 

i lives Liny Various stories on investments (NYT) 

k i Lche n A column on kitchen equipment (NYT) 

kissel go ft dance A weekly column on dance (NYT) 

kreml in Political events in Russia (NYT) 

1 ew i s co 1 iiiiin Anthony Lewis' column (NYT) 

1 peja Ladies' professional golf stories (AP) 

mail order Mail order suggestions (NYT) 

market A daily report on the stock market (NYT) 

marketp 1 ace Wall street news (NYT) 

mass digest Massachusetts news digest (AP) 

mass* lottery Massachusetts daily lottery results (AP) 

mass* news* Massachusetts News summaries (AP) 

mass* nightcap Massachusetts News summaries (AP) 

matchups Pre game analysis of upcoming sporting events (NYT) 

megabucks Massacnusetts Megabucks lottery stories (AP) 

mortgage Articles about mortgages (NYT) 

movie* Movie reviews and features about movies, including columns by Maslin 

and Canby (NYT) 

movie notes Movie column (NYT) 

movie review Movie reviews (NYT) 

names news People in the news (AP) 

nasdaq Selected over-the-counter stock prices (AP) 

news digest A capsule summary of top national news stories from the AP. 

newssummary A capsule summary of top news stories from either the AP or the New York 

Times. The New York Times news summary comes out once a day around 
midnight, and is identical to the news summary that appears on the first 
page of the B section of the printed paper. Use the query ( type : ny t) 
(subject: newssummary) for this summary. The AP summarizes local 
news many times a day. 

obits Obituaries (NYT) 

ol y Olympics coverage (AP) 

on 1 anguage Column by William Satire on the English language (NYT) 

outdoors Column on outdoor activities (NYT) 

patents Patents of special interest that have recently issued (NYT) 

paperbacks Paperback bestseller list (NYT) 

people Column on people in the news (AP) 

personal finance Coiumn on personal finance (NYT) 

personal heal th Column on persona! health (NYT) 

pga Professional golf stories (AP) 

pop Articles on popular music (NYT) 

practical traveler Travel advice (NYT) 

produce Boston wholesale produce prices (AP) 
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prospects Financial prospects for particular business sectors (NYT) 

quest ionbox Sports questions and answers (NYT) 

quotes Notable quotations (AP) 

i\ii; i ng Horse laciny news (NYT) 

records Recent classical record releases (NYT) 

res ton column James Reston's column (NYT) 

s ussel 1 art John Russell's art column (NYT) 

saf i re col umn Column by William Safire that is not "On Language" (NYT) 

science q a Science questions and answers (NYT) 

science watch Short summaries of recent scientific news (NYT) 

rxotus Supreme Court (of the United States) news (AP) 

scouting Stories on sports players (NYT) 

silk column Financial commentary by Leonard Silk (NYT) 

ski Column on skiing (NYT) 

•/.ports briefs Brief stories about sports (AP) 

sports minute Latest sports stories (AP) 

sports watch Time tables for sporting events (AP) 

stocks Articles on the stock market (NYT) 

tabletalk Food column (NYT) 

Lech* Reports on new and interesting technologies (NYT) 

.el erate Interest rates, including T-bills, Eurodollar, Federal discount rate etc. (AP) 

theater Articles about and reviews of the theater (NYT) 

transac ti oris New York Stock Exchange trading volume (AP) 

travel Various travel stories (AP) 

travel notes Vacation ideas (NYT) 
travel ers forecast* Weather forecasts for selected cities (AP) 

iv revi ew Reviews of upcoming television programs (NYT) 

i. 1 ' tonigh t Tonight's TV programs; sent three days in advance (NYT) 

t.v weekend Weekend television (NYT) 

vacation Vacation notes and ideas (NYT) 

vecsey column Sports column (NYT) 

v i deo Column on home videotapes (NYT) 

»:al 1 street Reports on Wall Street trading (AP) 

Washington brief Short news items from Washington D.C. (AP) 

watch Upcoming business events to watch (NYT) 

we a temps Temperatures and weather from major cities around the country (AP) 

weather-page Summary of weather around the country (NYT) 

wicker column Tom Wicker's column (NYT) 

wine* Column on wine (NYT) 
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BLANK PAGE 



3.4 — Useful Queries 

In addition to the subject specifiers above, the following queries will provide you with useful 

information. 



boston vicinity forecast* 
massachusetts daybook 
ski conditions 
(title: week review) 
(subject: mass* digest) 



Local weather forecast (AP) 

Newsworthy upcoming events in Massachusetts ( AP) 

Ski conditions at aftlocal ski resorts (AP) 

Articles from the Mew York Times "week in review" section 

Latest Massachusetts news capsules ( AP) 
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Section 4 — The Query Language 

The CommhiS software lets you describe articles that interest you using a simple language, called the 
q uay Imhh uuio- Hie query language is used primarily tor inter lines, but you can also type queries 
directly into the query Una. As described in Section 2, the system uses your filter to determine which 
articles to save for you. Using the query language, you can tell the system what articles interest you, 
in terms of their contents, source, author, subject, and a variety of other attributes. In this section, we 
explain the query language, starting with the simplest possible queries. 

The simplest possible query is a single word. Imagine, for example, that you are interested in ail 
articles that contain the word "peace". The corresponding query is the word peace. If you are 
interested in all articles that contain the words "war" and "peace", the corresponding query could be 
war and peace, war & peace, or simply war peace. Thus, you can combine two simple queries 
into a more specific query by means of and, &, or concatenation. 

Next, imagine that you are interested in all articles that mentioned the Supreme Court. You could use 
the query supreme cour t, but this query matches all articles that contain the words "supreme" and 
"court", regardless of whether they appear consecutively. To indicate that the words "supreme" and 
"court" must appear consecutively as a phrase , simply put them in quotes: "Supreme Court". A 
phrase may contam any number of words. The remote system cannot handle phrases, therefore 
typing "new york mets" has the same effect as typing the three words as explained in the 
preceding paragraph. 

Next, imagine that you are interested in all articles about computers, computing, computation, and so 
on. To catch till these articles, use the query comput*: it matches all articles that contain one or 
more words beginning with the letters "comput". These queiies are called stem queries , because 
they match any word that begins with a specified stem. There are two restrictions on stem queries: a 
stem query may not appear inside a phrase, and the stem must be at least two characters long. 

The following convention applies to all queries: uppercase and lowercase letters are considered the 
same, and al! punctuation characters in articles are treated as spaces, except for apostrophes, which 
are ignored. The system will not accept queries that contain punctuation characters, except for 
hyphens, which are treated as spaces. Thus, the query rogers matches the following words: 
"rogers", "Rogers", "Roger's", "Rogers'", and so forth. The queries "space cadet" and 
"space-cadet" match the following phrases: "space-cadet", "Space Cade;", etc. 

Next, imagine that you are interested in articles by a certain author, say John Smith. You could use 
the query Smith, but it matches every article that contains the word "smith", regardless of the 
context in which it appears. To rule out all these extra articles, use the que: y (author: smith); it 
malches all articles that have an author field containing the word "smith". Queries of this kind are 
called field-specific queries ; the possible fields (besides author) are listed in Section 3.1. Other 
examples of field-specific queries include ( sub ject : newssummary ) and (type: cis). 

Above, we showed how to combine two queries into a more specific query by means of and, &, or 
concatenation, in combination with field-specific queries, this combining rule is very useful; for 
example, the query ibm (category: financial ) matches all articles thai contain the word "!bm" 
and have a category field containing the word "financial". 



27 



CommInS users manual the query language 

In some situations, the date of an article is important. The query language permits you to specify a 
date using a special format; dates are recognized when enclosed in square brackets with the special 
key word da tE. 

| date jun 12 1086 ] 

Dates may be specifier! as a number of days in the past: 
[date 1] 

Dates may also be specified as ranges: 
[date jun \? : jun 1G] 

Note that the year will default to the current year. 

The date on which an article was written appears in the "date" field of the article. For example, to 
find all articles containing the word juggling that appeared in yesterday's New York Times, use the 
following query: 

juggling & (type: nyt) & (date: [date -lj) 

Oueries issued to remote database servers must be narrowed to specific dates, i.e. (date: [date 
-30 : -1)], and sources, i.e. (type: nyt). The CIS program will assist in this by suggesting what 
sources and dates are available, based on information read in from the configuration file. 

The examples on the next page illustrate the different kinds of queries, and the various ways in which 
they can be combined using and, or and not. 
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The Query 



Matches Articles that... 



peace 

"War and Peace" 

compii t* 

sk i * 

war and peace 
war & peace 
war peace 

war "and" peace 

war or peace 
war | peace 

not war 
~ war 

peace and (quiet or talks) 

(peace and quiet) or talks 

(subject: movie*) 

(author: smith (not John)) 

harvard (not (subject: f ootba ; 1 ) ) 
harvard (subject: (not Football)) 



..contain the word "peace" 

..contain the phrase "war and peace" 

..contain a word that begins with "comput", such 
as "computer", "computation" or 
"computability" 

..contain a word that begins with "ski", such as 
"ski", "skiing", "skid", "skin" or "skiascope" 

..contain the words "war" and "peace". The three 
queries shown to the left are equivalent. 

..contain the words "war", "and", and "peace" 

..contain either the word "war" or the word 

"peace". The two queries shown to the left are 
equivalent. 

..do not contain the word "war". The two queries 
shown to the left are equivalent. 

..contain the word "peace" and either the word 
"quiet" or the word "talks" 

..contain the words "peace" and "quiet" or the 
word "talks" 

..have a subject field containing a word that 
begins with "movie" 

..have an author field containing the word 
"smith" but not the word "John" 

.contain the word "harvard" but do not have a 
subject field containing the word "football". 
The two queries shown to the left are equivalent. 



The following are some examples of invalid queries, along with the reasons why they are invalid: 
The Query Is Invalid Because... 



"comput* languages" 
(author: (subject: smith)) 

Mr. Rogers' neighborhood 

(topic: reagan) 

(a or ( b ) or c 



..a stem query may not appear within a phrase 

..a field-specific query may not be nested inside 
another field specific query 

..punctuation (such as periods and apostrophes) 
cannot be entered in queries 

..topic is not a valid field name. The valid field 
names are listed in Section 3.1 . 

..parentheses must be balanced 
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Appendix I — Getting Started 

Important 



The Boston ConimlnS hardware and software have been designed for use with an IBM 
PC IM , XT IM , or AT IM personal computer with the following minimal configuration: 

• a monochrome or graphics display card and monitor, 

» version 2.1 or 3.1 of the MS DOS ,M operating system, or a corresponding version of 
PC-DOS ,M , 

• one floppy disk drive, 

• 256 K (kilobytes) of RAM, and 

• one RS-232 serial port. 

• one 1200-baud modem to retrieve articles from our New York Times database 
(optional) 

The Boston CommlnS hardware and software may also work with 100-percent compatible 
machines made by other manufacturers, provided that they have at least the 
configuration listed above. 



Introduction 

This appendix explains how to unpack the equipment and how to start using the hardware and 
software for the Boston CommlnS. It covers the following topics: 

» unpacking the equipment, 

a installing the hardware, 

» installing the software, 

• running the CommlnS program, and 
« stopping the Commlns program. 

Please read and follow these steps in order, even though you may have years of experience with 
i microcomputers and/or communications. 

1.1 — Unpacking the Equipment 

Ail ihe equipment, software and documentation for the Boston CommlnS is packaged together. Each 
package should contain the following: 

©One receiver (wrapped in bubble wrap) — an grey box with a signal strength meter, three 

connectors, and an MIT equipment tag 
o power suppiy (AC adaptor) — a black object with prongs that can be plugged into an 
ordinary outlet (1 1 volt AC) 

• One antenna — a flat, white ribbon cable in the shape of a large "T", with a special connector 
at the bottom of the "T" 

• One RS-2 32 cable — a gray, 20-foot cable with a 25-pin connector at one end and a "phono" 
plug at the other end 
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Figure 1-1 : Installation Diagram 

• One distribution disk — a standard 5'/i inch (360K format) floppy disk, packed inside the 

user's manual 
» One user's manual — you're reading it. 

Place the contents of the distribution package on a table, and make sure you have received all of the 
above items. If one or more items are missing, call the Boston CommlnS 'HOTLINE' at 
(617)-253-0007. 

Please save the box and packing materials for when you return the equipment to us at the end of this 
experiment. 

1. 2 — Installing the Hardware 

Wore: Please read this section once before you begin to put the equipment together. 

Positioning the Equipment 

The receiver, power supply, antenna, and cables can be arranged in any way that suits you, provided 
that they can be plugged into each other (see Figure 1-1). Place the antenna near a window, 
preferably on the side of your building nearest Boston's Back Bay neighborhood (the Prudential 
Tower, to be exact). Referring to Figure 1-1 , position the receiver so that (i) it can be plugged into the 
antenna, (ii) the 6-foot power cable can reach an ordinary outlet (110 volt AC) and (iii) the 20-foot 
RS-232 signal cable can reach your personal computer. 

Power 

Plug the power supply (AC adaptor) cable into an ordinary outlet (110 volt AC). Plug the other end of 
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the power cord into the matching connector on the receiver. 

RS-232 Cable 

Plug the gray "phono" plug at the end of the 20- foot RS 232 cable into the matching connector on 
the receiver. Then plug the ?5-pin RS 232 connector at the other end of this cable into the RS-232 
serial porl of your computer, for most installations, this description suffices. However, two unusual 
situations may apply to you: 

• If you have more than one RS-232 serial port on your personal computer, you must know which 
is port 1 and which is port 2. Normally, the Commlns software expects the receiver to be 
connected to port 1 , but either port 1 or port 2 may be used. 

• If you have an IBM AT™ computer with a 9-pin serial port connector, you will need an adaptor 
cable that lets you connect the 25-pin RS-232 connector to the socket on the AT's rear panel. 

• If a mcdem is connected to either serial port one or two, the CIS program may be instructed to 
use it to retrieve information from a remote database server. 

Receiver 

Plug the antenna into the receiver. If you place the receiver near a window, be sure to protect it from 
rain and snow if you keep the window open. 

Antenna and Orientation 

Positioning the antenna properly is the most important part of installing the system. If the antenna is 
not in a good position, you may not get good reception. As discussed earlier, try to position the 
antenna near a window on the side of your building closest to Boston's Back Bay. Our transmitter is 
located atop of the Prudential Building. 

Note that the antenna looks like a large "T" (about four feet wide) — keep the top part of the T 
straight and taut. We have found that in most locations the best results are achieved when the top of 
the "T" is kept horizontal. While keeping the top of the antenna horizontal, rotate the antenna until 
you find the orientation that maximize? the reading on the receiver's sign.a: strength meter. For best 
results, do nol hold the antenna while you read the signal strength meter. Once you have found the 
orientation that maximizes the meter reading, fix the antenna in this position. 

If you are returning to this section because of poc reception, try one of the following: 

• Tape the antenna to your window — remember to keep the top of the "T" fully extended — ■ and 
check your reception. 

© Stand facing the Prudential Building and hold the antenna fully extended between your hands. 
Now lay the fully extended antenna down, fix it in this position, and chock your reception. 

© Instead of using the antenna supplied in the package, you can use another antenna; antennas 
designed for VHP TV will work very well. If the antenna does not have a plug that fits the socket 
on the receiver, connect it to the two screw terminals on the black connector (balun) provided 
with the antenna in the package. The antenna should be pointed towards the Prudential 
building for best results. 

If neither of these suggestions help, call the Boston CommlnS 'HOTLINE' at (617)-253-0007. 
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1.3 — Installing the software 

Note: Before you install the software, make sure that you are using version 2.1 or 3.1 of the 
MS DOS IM operating system, or a corresponding version of PC-DOS IM , 

Locate the Distribution Disk in the distribution package. Use the DOS "DIR" command to list the 
directory of the Distribution Disk. The disk should contain four files: 

• CIS.EXE 

• FILTER.TXT 

• HELP.TXT 
oCONFIG.TXT 

The instructions for installing the software depend on whether you have a hard-disk drive, two floppy 
disk drives, or only one floppy disk drive. Determine which of the following three sections is 
appropriate, and follow the instructions in that section. 
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1.3.1 — Installing the Software on a Hard Disk 

1 . Insert the distribution disk into drive A. 

2. Make the hard disk the default drive: 

c : <l i) Ler > 

Most hard disk systems use drive C to refer to the hard disk. If you have multiple hard 
disks, or your disk is known by a different drive letter, replace C in the instructions by 
the drive of your choice. 

3. Build a directory for the Boston CommlnS program, and change the current directory to be this 
new directory: 

mkdir \news <Enter> 

cd \news <Enter> 
Because the DOS file sys'em limits the root directory to 112 files, the Boston 
CommlnS data should be stored in a subdirectory. We recommend using a directory 
cailed \news. 

4. Copy the CommlnS files from the distribution disk: 

copy a: * . * <Enter> 
This command will copy four files: CIS.EXE, FILTER.TXT, HELP. TXT and 
CONFIG.TXT. 

5. Remove the distribution disk from the floppy disk drive, and store it in a safe place. 

Keep the distribution disk as a backup. 

6. Start the Community Information System program: 

cis <Enter> 

7. Turn to Appendix 1.4 -- Running the CommlnS Program. 
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1.3.2 — Installing the Software with Two Floppy Disk Drives 

1 . Take a blank disk that has been formatted with the /S option. 

If yon do not have a blank system disk handy, format a new disk now. Make sure the 
new disk is not write- protected: remove the piece of tape covering the write-protect 
notch on the side of the disk if necessary. 

2. Label this blank system disk "Boston CommlnS Program". 

From now on, we will refer to this disk as the "program disk". 

3. Take another blank disk, this one formatted without the /S option. 

Use a disk formatted without the /S option, because it has mare space for data 
storage. 

4. Label this second blank disk "Boston CommlnS Data". 

By keeping the data on a separate disk from the program, you will be able to store 
more information. From now on, we will refer to this disk as the "data disk". 

5. Insert the distribution disk in drive A. 

6. Insert the program disk in drive B. 

7. Copy the file CIS. EXE from the distribution disk onto the program disk: 

copy a:cis.exe b: <Enter> 

8. Remove the program disk from drive B, and insert the data disk in drive B. 

9. Make drive B the default drive: 

b: <Enter> 

10. Build a directory for the Boston CommlnS data, and change the current directory to be this new 
directory: 

mkdir \news <Enter> 

cd \news <Enter> 
Because the DOS file system limits the root directory to 112 files, the Boston 
CommlnS data should be stored in a subdiiectory. We recommend using a directory 
called \news. 

11. Copy the CommlnS text files from the distribution disk into the \news directory: 

copy a:*.txt <Enter> 
This command will copy three files: FILTER.TXT, HELP. TXT and CONFIG.TXT. 

12. Remove the distribution disk from floppy disk drive A, and store it in a safe place. 

Keep the distribution disk as a backup. 

13. Insert the program disk in drive A. 

When you run the CommlnS program, the program disk should be in drive A, and the 
data disk in drive B. 

14. Start the Community Information System program: 

a:cis <Enter> 
The program is on drive A, and the \news directory containing the data is on drive B. 

15. Turn to Appendix 1.4 — Running the CommlnS Program. 
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1.3.3 — Installing the Software with One Floppy Disk Drive 

1. Take a blank disk, formatted with the /S option. 

If you do not have a blank system disk handy, format a new disk now. Make sure tlte 
new disk is not write-protected: remove the piece of tape covering the write protect 
notch on the side of the disk if necessary. 

2. Label the blank system disk "Boston CommlnS". 

From now on, we will refer to this disk as the "program disk". 

3. Insert the program disk in the floppy disk drive. 

4. Build a directory for the Boston CommlnS data, and change the current directory to be this new 
directory: 

mkdir \news 
<Enter> 

cd \news <Enter> 
Because the DOS file system limits the root directory to 11 2 files the Boston CommlnS 
data should be stored in a subdirectory. We recommend using a directory called 
\news. 

5. Copy the CommlnS files from the distribution disk: 

copy b : * . * <Enter> 
You will be asked to remove the program disk and insert the distribution disk. This 
command will copy four files: CIS.EXE, FILTER.TXT, HELP.TXT and CONFIG.TXT. 
You may need to swap the two disks several times. 

6. Remove the distribution disk from the floppy disk drive, and store it in a safe place. 

Keep the distribution disk as a backup. 

7. Re-insert the program disk in the floppy disk drive. 

8. Start the Community information System program: 

cis < E n t e r > 

9. Turn to Appendix 1.4 — Running the CommlnS Program. 
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1.4 — Running the CommlnS Progiam 

At this point, the Boston CommlnS program should be running on your PC. Normally, the program 
assumes the receiver is connected to port 1. If your receiver is connected to port 2, hold down the 
< A 1 1 > key and press V to switch the system to port 2. 

You should now he "on the air". News articles received by the system will be stored in the \news 
directory. To verify that the system is working, press F8 and wait until the highlighted line at the top of 
the screen displays the words "Diagnostic Window". If the system is working, it should be receiving 
"intact packets" at a rate of about throe packets per second. Find the number of "intact packets" on 
the screen: it is displayed five lines above the highlighted line near the bottom of the screen. The 
number should be increasing steadily, at a rate of about three per second, occasionally interrupted by 
brief pauses that are followed by rapid catching up. If this is the case, everything is working; please 
turn to Section 2 — Using the Commins Software and follow the instructions for first-time users. 

if the number of intact packets is not changing, refer to the trouble-shooting guide in Appendix III. 

1.5 — Starting and Stopping the CommlnS Program 

i.5.1 — Starting the Conimlns Program 

The procedure for normal start-up depends on the hardware configuration of your personal 
computer: 

• If you have either a hard disk or a single floppy disk drive, use the cd command to change the 
current directory to the \news directory, and start the program by typing cis. 

• If you have two floppy disk drives, place the CommlnS program disk in drive A, the CommlnS 
data disk in drive R. use the b : and cd commands to change the current directory to the \nows 
directory on the data disk, and start the program by typing a : c i s . 

if your receiver is connected to port 2. you can use the " -2" option to tell the program to listen to 
port 2 right from the start: 

cis -2 <Enter> 
or 

a:cis -2 <Entpr> 

If you want trie ability to use a mod err: to retrieve information from remote databases, you must start 
the CIS program with the " d" option to enable duplex operation: 

cis -d <Enter> 
or 

a: cis -d <Enter-> 

You may configure the program to print articles in the foreground (necessary i : you do not have an 
IBM Graphics printer) by specifying the " -p" option: 

cis -p <Enter> 
or 

a: cis -p <Enter> 

Of course, options may be combined, for example: 
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cis -2 -p <Fnter> 

or 
a : c i s 2 p <:l n L«r> 

When you start the CommlnS program, it begins to receive data immediately. You should verify this 
by pressing the l : 8 key and checking to see that the number of "intact packets" is increasing. If the 
system is not receiving data, refer to trouble shooting guide in Appendix III. 

1.5.2 — Stopping the CommlnS Program 

To stop the CommlnS program, you should hold down the <Alt> key and press X, or execute the exit 
command that appears in every menu. This instructs the system to save its article directory on the 
disk and return to DOS. 



Wa rning: 

Do not siop the CommlnS program by turning off the power or by re booting your PC. 

If you interrupt the program in this way, the files used by the system may be left in an 
inconsistent state. When this happens, the program must be re-started using the " -r" 
option (described below). 



1.6 — Restarting after a Crash or Accidental Shutdown 

If the hardware or software running the Boston CommlnS fails or is inadvertently shut down without 
using the exit command, the files used by the system may be left in an inconsistent state. Depending 
on the cause cf the problem, you may wish to consult the trouble-shooting guide in Appendix III. 

If the system crashes oi is accidentally shut down, you should reboot the DOS operating system in 
one of the two standard ways — either (i) by turning your personal computer off for 30 seconds and 
turning it back on, or (ii) by simultaneously holding down the <Ctrl> and <Alt> keys and then pressing 
the <Del> key. We recommend the latter method, to minimize wear of the computer hardware. 

To restart the ComminS program, follow the instructions for normal start-up in Appendix 1.5.1, but 
invoke the CommlnS program with the " -r" option: 

cis -r <Enter> 

or, if you are using Port 2: 

cis -2 -r <Enter> 

The " -r" option instructs the Commlns program to rebuild the CommlnS directory file, 
CIS- DIR.TXT, by reading ail the article files on the disk and comparing them with the filter in the filter 
file. During the rebuilding process, the system displays the names of the files as it reads them; when 
this is finished, the system starts up as usual. Because of the large amount of disk reading and 
indexing that is required, the rebuilding process takes a large amount of time to execute. 

As always, the system should begin to receive data immediately. You should verify this by pressing 
the F8 key and checking to see that the number of "intact packets" is increasing. If the number of 
"intact packets" is not changing, refer to trouble-shooting guide in Appendix HI. 
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Appendix II — Setting Up The Remote System 



Note: 

If you do not have a modem that is capable of using a 1200 baud communications, you 
cannot use the remote access feature of the Boston CornmlnS program. Please check 
that your modem has 1200 baud capabilities before continuing. 

If you have only one serial port, the program cannot listen to broadcast articles and 
access the New York rimes database simultaneously. However, you can do one or the 
other at any time, provided that you connect the modem o> receiver to the serial port and 
swap the ports within the program. 

11.1 — Hayes Modems 

If you have a Hayes or Hayes compatible modem, the Boston CornmlnS software does not need any 
additional set up, beyond starting the program with the d option. (See Appendix 1. 5. 1) 

II. 2 — Non-Hayes Modem 

If your modem is not Hayes compatible you will have to first establish a connection to the remote 
server prior to issuing remote queries to the Boston CornmlnS software. The following procedure 
must be executed with a modem communications program: 

• Reset the modem to its initial state. 

« Set the modem for 1200 baud mode, if applicable. 

o Dial the remote server at (GI7) 250 -7161. If you get a busy signal, continue to attempt to make a 
connection. Once a connection is established, you should receive a 'login:' prompt. !r you did 
not receive this prompt, you may not have a 1200 baud modem. Check your manual. 

• Exit your modem communications program, without severing the connection. 

• Enter the Boston ComminS software with the -cl option (See Appendix 1. 5. 1) 
» The software will check if the modem is connected, prior to sending a query. 

• If there is a problem with the connection and the Boston CornmlnS program needs to rediai ihe 
modem, you will have to exit the program and execute the above steps again. The program 
cannot reestablish a connection on nonT layes or compatible modems. 

<s> NOTE: If you are running the Boston CornmlnS software in the background, you do not have to 
exit the program each time to establish a modem connection. Simply make Ihe connection with 
the modem program with the Boston CornmlnS software in the background. 

If you are still having difficulties, contact the Boston ComminS 'HOTLINE' at (GI7) 2133-OCO/. 
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Appendix III — Trouble-shooting Guide 

If you are having trouble installing or using the system, check this list of common problems, 
symptoms, and solutions. If you cannot resolve the problem, call the Boston CommlnS 'HO I LINE' at 
(6i7)-253-0007. If none of the consultants are available, please leave a message on the answering 
machine anci someone will call you back. 

Piease report 'crashes' (defined below) to the Boston CommlnS 'HOTLINE'; try to describe as many of 
the keystrokes and system actions leading up to the crash as you remember. 



Symptom 



Possible Problems 



Solution 



The program does not start up, 
and does not respond to the 
keyboard. 



The program 'freezes' while 
starting up, and does not 
respond to the keyboard. 



rite program stops responding 
to the keyboard. 



The program prints a "Fata! 
Error" message when 
starting up. 



The program exits to DOS 
unexpectedly. 



Not enough memory in your PC. 
(You need at least 256 K of 
RAM in order to run the 
Etoston CommlnS program.) 



Install more memory. 



Some previous program left the 
PC in an unusable state 
(probably because of 
disorderly termination). 



Re-boot the PC and re-start the 
program. 



The program has crashed. 



Re-boot the PC and restart the 
program using the command 
"cis -r". Please report the 
crash to the Boston 
CommlnS 'HOTLINE'. 



The system files are in an 
inconsistent state (perhaps 
because of a previous crash 
or accidental shutdown). 



Re-start the program using the 
command "cis -r" (See 
Appendix 1.6). 



The program got into a situation 
that was considered 
in possible, and crashed. 



The file STDOUT.TXT will 
contain an error message. 
Please record this message, 
and when you report the 
crash cc the Boston 
CommlnS HOTLINE', report 
the error message as well. 
Re-boot the PC and restart 
the program using the 
command "cis -r ". 



(continued) 



40 



TROUBLE SHOOTING GUIDE 



COMMlNS USER'S MANUAL 



Symptom 



Possible Problem 



Solution 



The number of "intact packets' 
(in the diagnostic window) 
does not change. 



The number of "articles 
received" (in the diagnostic 
window) does not change. 
The number of "unframed 
packets" and/cr the number 
of "checksum errors" are 
increasing. 



The number of "articles 
received" (in the diagnostic 
window) is increasing, but 
the number of "matching 
articles" does not change. 

The number of "matching 
articles" (in the diagnostic 
window) does not change. 
The number of "articles 
received" and the number of 
"articles wit.li unknown keys" 
are increasing at the same 
rate. 



The receiver is not connectt 



The program is listening to the 
wrong serial port. 



The radio station is off the air. 



Poor reception. 



The leads on the antenna 
connector are touching. 



The program does not have a 
filter. 



The program does not have any 
keys loaded. 



Make sure that the receiver is 
plugged in, and that the 
cable between the receiver 
and the personal computer is 
connected. 

Lither type A-V to instruct the 
program to listen to the other 
por*, or connect the receiver 
to the other port. 

Our data transmissions are 
carried by WERS Boston, FM 
88.9. WERS is generally off 
the air from 2:00 until 6:00 
am Listen to WERS on a 
regular FM radio, and wait 
until it comes back on the air 

Refer to the discussion on 
"Antenna and Orientation" in 
Appendix 1.2 — Installing The 
Hardware. 



Move the leads on the antenna 
connector so they no longer 
touch. 

Either re-start the program in a 
directory that has a filter file 
(Fil_TER.TXT), or insert one 
or more filter lines into the 
filter window. 



Copy the CONFIG.TXT file from 
the distribution disk into the 
\news directory, and restart 
the program. 



(continued) 
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Symptom 



Possible Problem 



Solution 



Occasional periods of poor 
reception. 



Difficulty establishing a 
connection to a remote 
database server. 



Radio interference. 



Not using a Hayes-compatible 
1200 baud modem. 



Various connection problems. 



Move the receiver, antenna, and- 
PC away from other electrical 
equipment. 



Use a standard terminal or 
modem program to establish 
a connection to the remote 
server and wait until you 
receive a login: prompt 
before starting the CIS 
program. 

Press <A-H> to reset the 
connection from within the 
CIS program, then turn the 
modem power off and on, 
and attempt a remote query 
again. Or, attempt to 
"strobe" the modem, ie. 
press <A-V> twice. 
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Appendix IV — Differences from Version 6.0 (7) 

IV. 1 — Keystroke Changes 

In an attempt to make the program easier to use, we have changed some of our keystroke bindings to 
a "more standard" form: 

Old Key Explanation 

? The Ft key replaces ? and instructs the system to display the hc[£ file. It contains 

an overview of commands and queries. 

F1 The F3 key replaces F1 and instructs the system to display the window selection 

menu . 

<Esc> The / key replaces the <Esc> to display the command menu for the current 

window (see Section 2 — Using the CommlnS Software). Additionally, <Esc> no 
longer is used to process menu items, see <Enter> below. 

<C-C> The <Esc> key replaces the <C-C> and (shorthand for the command do nothing) 

instructs the system to exit the current menu or cancel inserting a filter line. If 
neither of these cases apply, <Esc> still does nothing. 

<Enter> The <Entor> key instructs the system to process whatever is currently being done. 

Therefore, when there is a menu on the screen, the <Enter> key instructs the 
system to ex ecute the selected command. When inserting a filter line, <Enter> 
instructs the system to finish inserting the edited line. Any other time the <Enler> 
key (shorthand for the command show summaries) instructs the system to process 
the query on the query line and to display summaries of the matching articles (see 
Section 2. I — The filter Window). 

<A-Y> The <AE> key is. now used for confirmation to execute commands (when 

applicable) and the <A-Y> is used to blank the screen. 

F2 The <A-S> key replaces the F2 key and instructs the system to togyie between 

displaying and turning of the budget display. 

F1 The F2 key replace-.; the F1 key and instructs the system to snow filter window. 

F3 The F4 key replaces the F3 key and instructs the system to show summary 

window. 

F5 The F6 key replaces the F5 key and instructs the system to snow articl i-; window. 

F7 The F8 key replaces the F7 key and instructs the system to show diagnostic 

window. 

F9 The F10 key replaces the F9 key and instructs the system to show options 

window. 
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IV. 2 — Remote Queries 

A brand new feature of the current software is the ability to access a complete database of Now York 
I iinos articles. This database is stored on several database servers at MIT. Users must have a 1200 
baud modem to use this feature. 

The service is invoked by using the -d option at startup (see Appendix 1.5. 1 - Starting the CommlnS 
Program) and issuing queries with <C-Enter>, instead of <Enter> (see Section 2. 1 ~- The Filter 
Window and figure 2 3). Also, Appendix II will help set up your modem for use with the software. 

IV. 3 — Screen Dimming 

If no keys are pressed for ten minutes, the CIS program now enters a 'screen protect' mode. In this 
mode, the screen is blanked, and a message ("Bounce") is printed. This message is moved randomly 
to different places on the screen. The screen-dimming mode prevents the CIS display from becoming 
permanently burned into the screen. Typing any keys restores the screen, then executes the 
command indicated by the key that was pressed. The menu item "Itiie the screen (A-C)" in the 
options window immediately blanks the screen and displays the message. 

If you prefer not to see any message when the screen is blanked, select "Blank the screen (A-Y)" 
from the options menu. This is particularly useful if you run the CIS program under a multi-tasker 
such as Double-Dos (TM) or DesqView (TM), because it prevents any output from appearing on the 
screen. 

IV. 4 — Printer Support 

The CIS system now supports several different printer models. 

IBM printers may be run in the default (background) mode. In this mode, additional CIS commands 
can be processed while the article is being printed. Also, relevant words and phrases are highlighted 
when articles are printed on the IBM printer. In background mode, the CIS program sends characters 
directly to the printer, bypassing print spoolers and all DOS calls. 

Other printers may be used in 'foreground'. No additional CIS commands can be entered until 
printing is complete. In foreground mode, the CIS system send!:- characters to the printer by issuing 
DOS calls. Special printer drivers and spoolers may be used. 

The foreground mode may be invoked using the shorthand (A-G) (see Section 2.5 — The Options 
Window) or at startup using the -p option (see Appendix 1.5. 1 — Starting the JommlnS Program). 
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Appendix V — Summary of Commands 

V.1 — Special Function Keys 

The following keys on the PC keyboard have special meaning to the Commlns software: 



F1 



F3 



<Esc> 



<Enter> 



<C-Enter> 



The F1 key instructs the system to display the hel p file. It contains an overview of 
commands and queries. 

The F3 key (shorthand for the command SHOW window selection menu) instructs 
the system to display the window selection menu . 

The / key instructs the system to display the command menu for the current 
window (see Section 2 — Using the CommlnS Software). 

The <Esc> key (shorthand for the command do nothing) instructs the system to 
exit the current menu or cancel inserting a filter line. If neither of these cases apply 
<Esc> still does nothing. 

The <Enter> key instructs the system to proce ss whatever is currently being done, 
When there is a menu on the screen, the <Enter> key instructs the system to 
execute the selected command. When inserting a filter line (or editing a budget), 
<Enter> instructs the system to insert the edited line (or budget). Any other time the 
<Enter> key (shorthand for the command show summaries) instructs the system to 
process the query on the query line and to display summaries of the matching 
articles (see Section 2. 1 — The Filter Window). 

The <Control-Enter> key (shorthand for the command show summaries from 
remote system) instructs the system to subm it the query on the query line to a 
remote database server and to display summaries of the matching articles (see 
Section 2. 1 — The Filter Window). 



V.2— Scroll Keys 

The following keys can be used to scroll through a window: 

<PgDn> Show the next page 

<PgUp> Show the previous page 

<Home> Show the first page of the window 

<End> Show the last page of the window 

| Select the next line (or summary) 

T Select the previous line (or summary) 

Shift- j Move forward one line (or summary) 

Shift-T Move back one line (or summary) 
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V.3— Editing Keys 

The following keys can be used to edit the query line. They can also be used in the 'edit boxes' 
cretited by the commands change budget of current line and insert a new line. Note: the 
<Backspace> key is the key with a left arrow (<-- ) on a gray background. 

<Backspace> delete the character before the cursor 

C-W delete the word before the cursor 

CD delete the character after the cursor 

C-K delete everything after the cursor 

<Del> delete the entire lino 

<— or C-B move the cursor to the left 

—y or C-F move the cursor to the right 

C-A move the cursor to lhe beginning of the line 

C-E move the cursor to the end of the line 

V.4 — Alphabetical Listing of Commands 

The next page contains an alphabetical listing of the commands recognized by the CommlnS 
software, along with their shorthand keys and the menu(s) in which each command is listed. 18 The 
shorthand keys for the commands listed in the window selection menu and the options window 
command menu are available in every window; these keys are marked with an asterisk. Ail other 
shorthand keys are available in a given window only if the corresponding command is listed in the 
command menu for that window. 



The prefix "A-" refers to the <Alt> key: for example, A-B moans "hold down the <Alt> key and press b". Similarly, the 
prefix "C-" refers to the <Ctrl> key: for example, CD means "hold down the <Ctrl> key and press d". 
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Name of Command 



Shorthand 



Listed in: 



BLANK THE SCREEN AY 

CHANGE BUDGET OF CURRENT LINE A-B 

DELETE ALL ARTICLES IN LIST A-K 

DELETE ALL MATCHING ARTICLES AK 

DELETE CURRENT ARTICLE AD 

DELETE, THEN SHOW NEXT ARTICLE A-D 

DELETE, THEN SHOW NEXT UNREAD A-J 

DELETE, THEN SHOW SUMMARIES A-M 

DO NOTHING <ESC> 

EXIT TO DOS A-X 

HANGUP REMOTE CONNECTION A-H 

IDLE THE SCREEN AC 

INSERT ANEW LINE A-l 

MOVE CURRENT LINE DOWN A-N 

MOVE CURRENT LINE UP A-U 

PRINT ALL ARTICLES IN LIST A-A 

PRINT ALL MATCHING ARTICLES A-A 

PRINT CURRENT ARTICLE A-P 

PRINT CURRENT ARTICLE A-P 
PRINT IN BACKGROUND/FOREGROUND A-G 

REMOVE CURRENT LINE A-W 

RESET COUNTERS TO ZERO A-0 

SHOW ARTICLE WINDOW F6 

SHOW CURRENT ARTICLE A-R 

SHOW DIAGNOSTIC WINDOW F8 

SHOW FILTER WINDOW F2 

SHOW FIRST ARTICLE A-R 

SHOW HELP FILE F1 

SHOW NEXT ARTICLE. A-N 

SHOW NEXT UNREAD ARTiCLE A-Z 

SHOW OPTIONS WINDOW F10 

SHOW REMOTE SUMMARIES <CEnter> 

show summaries <Enter> 

SHOW SUMMARY WINDOW F4 
SHOW (THE) WINDOW SELECTION MENU F3 

STOP PRINTING AND EMPTY QUEUE A-Q 

SWAP MODEM /RECEIVER PORTS A-V 

TURN BEEP-ON-ARRIVAL ON/OFF A-l 

TURN BUDGE! DISPLAY ON/OFF A-S 

TURN PRINT-ON-ARRIVAL ON/OFF A-2 

TURN RECEIVER ON/OFF A-0 



options window command menu 
filler window command menu 
summary window command menu 
filter window command menu 
summary window command menu 
article window command menu 
article window command menu 
article window command menu 
every menu 
every menu 

options window command menu 
options window command menu 
filter window command menu 
filter window command menu 
filter window command menu 
summary window command menu 
filter window command menu 
filter window command menu 
summary window command menu 
options window command menu 
filter window command menu 
diagnostic window command menu 
window selection menu 
summary window command menu 
window selection menu 
window se'oction menu 
filter window command menu 
startup message 
article window command menu 
article window command menu 
window selection menu 
filter window command menu 
filier window command menu 
window selection menu 
every mem; 

options window command menu 
options window command menu 
filter window command menu 
options window command menu 
filter window command menu 
options window command menu 
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Appendix VI — Files used by the system 

VI. 1 — The CommlnS Directory File 

The ComminS directory file, CIS - DIR.TXT, contains information about the articles on the disk: it 
contains an index, which is used to speed up the processing of queries, and it contains summaries of 
ihe articles, so that these can be displayed without delay. It also contains a list of articles that you 
have deleted, so that these articles can be filtered out if they are received again. 

When the program is running, the contents of the directory file is stored in memory; it is saved on the 
disk only when you exit from the program. This explains why the program should always be stopped 
using the exit command. If the directory file is missing, the program should be started with the " -r " 
option (see Appendix 1.6 — Restarting after a Crash or Accidental Shutdown). 

VI. 2— The Filter File 

The filter file, FILTER.TXT, contains your personal filter. In this file, each filter line is stored as a 
separate line, along with two numbers: the first number is the budget for that line, and the second 
number indicates whether "beep" or "print" is turned on for that filter line (see Section P..1 ----- The 
i'ilter Window). 

VI. 3— The Help File 

The help file, HELP. TXT, contains a brief description of how to use the system. The system displays 
ihe tutorial when you press F1 . 

VI. 4 — The Configuration File 

The configuration file, CONFlG.TXT, contains information that is used by the CIS program, but may 
■Jiange at a future date. Currently, there are entries for two kinds of information, decryption keys and 
remote database descriptors. 

An entry for a decryption key includes a key number and the hexadecimal representation of the key: 
k 17001 131b3clf7ea8fbb20 

/-n entry for a remote database includes the telephone number used to access the database and a 
description of the contents of the database: 

cl 2587161 ((type: ny t ) & (date: [date -90 : 0])) 

VI. 5 — The Error File 

The error file, STDOUT.TXT, is written whenever the program exits. It normally does not contain any 
useful information; however, when the program exits to DOS unexpectedly, it leaves an error message 
in this file. Please record this message, and report it to the Boston CommlnS 'HOTLINE' at 
(617)253-0007. 
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VI. 6 — Article Files 

Article files have names of the form tymmddn.nnn, where t indicates the type of the article (A for 
Associated Press, N for New York Times, or C for CommlnS announcements); y is the last digit of the 
year, mm is the month, do is the date, and n.nnn is a four-digit serial number. Each article Me 
contains a number indicating the number of lines of text, followed by a set of numbers that indicate 
which words in the article should be highlighted for display (see Section 2.3 — The Article Window), 
followed by the text of the article, yes 
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Appendix VII — Your Responsibilities 

As a volunteer in the experiment to test the Boston Community Information System, you have several 
responsibilities. A copy of the agreement that you have signed is reproduced on the next page as 
Figure V-1 . 

VII. 1 — Your Responsibilities io the Boston CommlnS Project 

We at the Boston CommlnS project want and need your active participation in the evaluation and 
testing of the CommlnS hardware, software and documentation. This means that we would like you to 

• use the system to the fullest extent of its features, 

• give us your thoughtful appraisal of the existing features, and 

• give us your suggestions for possible improvements. 

You may express these ideas, suggestions, and questions to us in many ways — in writing or by 
telephone — as often as you wish. However, at a minimum, and even if you have provided feedback 
in other forms, you must fill out a Questionnaire once a month. This is the minimal requirement for 
your continued participation in the experiment. 

VII. 2 — Your Responsibilities Regarding Use of the Information Received 

To conduct this unique experiment in the digital broadcast of news and information, MIT has entered 
into understandings and legal agreements with the Associated Press, the New York Times Company 
and Mead Data Central, Inc As a volunteer in this experiment, you have agreed 

"l.not to make more than one copy — in any form — of any information 
received; 

2. not to retain copies — in any form — of more than an "insubstantial part" of 
the information received; 

3. not to transfer any of the information received — in any form — to third 
parties, whether or not for profit; and 

4. noi to retain any of the information received from the New York Times — ■ in 
any form — for more than 90 days. 

5. to return all the equipment to MIT upon request. 

In view of the unique nature of this experiment, we feei that the responsibilities outlines above are 
reasonable. !f you do not act in keeping with the letter and the spirit of the aoreement, we will request 
that you return ail loaned equipment and software to us immediately. 



50 



YOUR RESPONSIBILITIES COMMlNS USER'S MANUAL 



BostonCornrnlnS Z53-0007 

c/o MIT Laboratory for Computer Science, Room NE43-403 
545 Technology Square, Cambridge, MA 02 1 39 



Revised 29 September 1 986 



Full Name (printed): 



Legal Agreement with Mead Data Central, Inc. 



The above designated "Recipient" agrees that it will not retain any copies of data from the New 
York Times in any form , whether print, machine readable or otherwise for 8 period of more 
than 90 days, and that any such data retained will be 1 ) limited to single copies, 2) never 
consist of more than an insubstantial part of the entire database made available to NIT , and 3) 
will not be transferred, whether x not for profit to any third party. It is agreed that all copies 
of such data will be returned or destroyed earlier than the 90-day maximum retention period 
upon written request from MIT, The New York Times Company, or Mead Data Central, Inc. 



Agreed 



Signature of Recipient Date 



Understanding and Agreement with MIT 

Whether or not for profit, I understand and agree not to transfer in printed or electronic form 
any information received via the Boston CommlnS project to any third party. 

I understand and agree that I must complete and return a questionnaire provided for that purpose 
to the Boston CommlnS Project once a month or else have to return the receiver and software to 
the project. 

I understand and agree that the software and hardware will remain the property of MIT and that I 
must return all the materials used in this test of the Boston CommlnS system either ( i) at the 
end of the experiment in approximately 1 2 months or ( ii) upon written notice from the project 
-- whichever comes first. 

I understand and agree that MIT has made no expressed nor implied guarantees to provide this 
information service without Interuption throughout the duration of the experimental test. 

Agreed 



Signature of Recipient Date 



Copies of this signed agreement will be held by ( i) the Recipient, ( ii) the Boston CommlnS 
Project at MIT, and Mead Data Central, Inc. 



Figure VII- 1: Text of Agreement 
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